home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / cb.z / cb
Text File  |  1998-10-30  |  3KB  |  130 lines
  1.  
  2.  
  3.  
  4. CCCCBBBB((((1111))))                          SSSSiiiilllliiiiccccoooonnnn GGGGrrrraaaapppphhhhiiiiccccssss                          CCCCBBBB((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cb - C program beautifier
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ccccbbbb [ ----ssss ] [ ----jjjj ] [ ----nnnn ] [ ----llll leng ] [ ----tttt shiftwidth ] [ file ... ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _c_b command reads C programs either from its arguments or from the
  16.      standard input, and writes them on the standard output with spacing and
  17.      indentation that display the structure of the code.  Under default
  18.      options, _c_b preserves all user new-lines.
  19.  
  20.      _c_b accepts the following options.
  21.  
  22.      ----ssss          Canonicalizes the code to the style of Kernighan and Ritchie
  23.                  in _T_h_e _C _P_r_o_g_r_a_m_m_i_n_g _L_a_n_g_u_a_g_e.
  24.  
  25.      ----jjjj          Causes split lines to be put back together.
  26.  
  27.      ----nnnn          Causes pairs of left braces with only whitespace between them
  28.                  to be interpreted as code braces.  By default, such pairs of
  29.                  braces are assumed to be structure initializations and less
  30.                  indentation is done; this causes code-brace pairs to produce
  31.                  odd output.   An example will clarify this.
  32.                  File t.c:
  33.  
  34.                     int x; main() { { { x = 3; } } }
  35.                  ccccbbbb tttt....cccc produces
  36.  
  37.                     int x;
  38.                     main() {
  39.                             { {
  40.                                     x = 3;
  41.                             }
  42.                     }
  43.                     }
  44.                  Note the right braces prematurely at the left margin.  On the
  45.                  other hand,  ccccbbbb ----nnnn tttt....cccc produces
  46.  
  47.                     int x;
  48.                     main() {
  49.                             {
  50.                                     {
  51.                                             x = 3;
  52.                                     }
  53.                             }
  54.                     }
  56.  
  57.  
  59.  
  60.  
  61. Page 1                           Release 6.4
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. CCCCBBBB((((1111))))                          SSSSiiiilllliiiiccccoooonnnn GGGGrrrraaaapppphhhhiiiiccccssss                          CCCCBBBB((((1111))))
  69.  
  70.  
  71.  
  72.      ----llll  _l_e_n_g    Causes _c_b to split lines that are longer than _l_e_n_g.
  73.  
  74.      ----tttt  _s_h_i_f_t_w_i_d_t_h
  75.                  tells _c_b to use a soft tab stop which is different from the
  76.                  hard tabs. Tab characters will be used to save space where
  77.                  possible.
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      cc(1).
  81.      Kernighan, B. W., and Ritchie, D. M., _T_h_e _C _P_r_o_g_r_a_m_m_i_n_g _L_a_n_g_u_a_g_e.
  82.      Prentice-Hall, 1978.
  83.  
  84. BBBBUUUUGGGGSSSS
  85.      Punctuation that is hidden in preprocessor statements will cause indenta-
  86.      tion errors.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  124.  
  125.  
  126. Page 2                           Release 6.4
  127.  
  128.  
  129.  
  130.